Skip to content

Add PRD to steel thread skill - #1

Open
TRahulSam1997 wants to merge 2 commits into
mainfrom
feat/prd-to-steel-thread
Open

Add PRD to steel thread skill#1
TRahulSam1997 wants to merge 2 commits into
mainfrom
feat/prd-to-steel-thread

Conversation

@TRahulSam1997

Copy link
Copy Markdown

Why

Product PRDs describe what to build, but technical planning benefits from first identifying the thinnest end-to-end steel thread and then sequencing the remaining scope as demo-ready vertical slices. This skill creates that bridge without embedding organization-specific domain knowledge.

Parallelism must be considered while slices are formed, not added after technical tasks are generated. Capturing Dev+agent pair capacity, dependencies, safe parallel groups, and synchronization points in steel-thread.md gives Spec Kit /speckit.plan or an equivalent SDD planning step the delivery constraints needed to produce an executable design without forcing unsafe concurrency.

What changed

  • adds the host-agnostic prd-to-steel-thread skill
  • produces steel-thread.md with a solo steel thread, demo-ready slices, JIT infrastructure, and capacity-aware parallelism
  • includes generic PRD and steel-thread templates
  • adds an SDD planning/design hand-off that supports Spec Kit and other workflows
  • documents the skill in the toolkit catalogue

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@TRahulSam1997

TRahulSam1997 commented Aug 13, 2026

Copy link
Copy Markdown
Author

Engagement example of skill being used on a real feature that was shipped.

Running agent with skill

Running.agent.with.skill.mov

Internal agent asking human questions (guided by skill)

Ravi.asking.human.questions.guided.by.skill.mov

Internal agent asking human questions for further clarification after creating steel thread doc

Ravi.asking.human.questions.for.further.clarification.after.creating.steel.thread.doc.mov

Steel thread ready!

The next step is to run /speckit.plan on a fresh agent and feed this steel thread MD file along with the PRD to begin the build process 🔨

Usually the PRD itself is fed into /speckit.specify as that's product oriented whereas /speckit.plan is the technical implementations steps.

@TRahulSam1997
TRahulSam1997 marked this pull request as ready for review August 13, 2026 06:31

@bsigney bsigney left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Really like this. What makes it work for me: steel thread as Slice 0 and solo before anything fans
out, infrastructure only in the slice that exercises it, and "capacity is a ceiling, not a target" —
that last one is the opposite of how most plans get written. Flat Slice 0..N instead of lanes and
1a/1b keeps it readable too. Repo side's clean: validate passes, links stay inside the skill,
README row's there.

Just a few inconsistencies to sort out — mostly the same rules written in several places, and a
couple have already drifted apart from each other. Comments inline.

Comment thread skills/prd-to-steel-thread/SKILL.md
Comment thread skills/prd-to-steel-thread/templates/steel-thread.md Outdated
Comment thread skills/prd-to-steel-thread/SKILL.md
Comment thread skills/prd-to-steel-thread/templates/prd-input-template.md Outdated
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

@bsigney bsigney left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just two critical points Rahul.
Otherwise everything else looks good.


**Gate:** obtain explicit human confirmation before writing the final artifact.

Then write `steel-thread.md` next to the source PRD using

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

written with no existence check — no instruction to check whether one already exists and what to do with it.
Will be overwritten according to this.


Do not create artificial sub-slices merely to occupy every pair.

### 8. Confirm the roadmap and write the artifact

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The architecture path, infrastructure ownership, SDD command, pair count and Slice 0 approval are each established through a gate, then held only in conversation. Nothing is written until step 8. On a compacted, resumed or interrupted run the agent still has the PRD and the template in front of it, so it doesn't start over. It re-derives an architecture path and a pair count instead, which is what SKILL.md:43-44 forbids: "Do not assume architecture, infrastructure, team capacity." The rule is asserted with no mechanism behind it

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants